JMÉNO¶

getprotoent, getprotobyname, getprotobynumber, setprotoent, endprotoent - funkce pro práci s databází protokolů

SYNTAXE¶

#include <netdb.h>

struct protoent *getprotoent(void);

struct protoent *getprotobyname(const char *name);

struct protoent *getprotobynumber(int proto);

void setprotoent(int stayopen);

void endprotoent(void);

POPIS¶

Funkce getprotoent() přečte další záznam z databáze protokolů (viz protocols(5)) a vrátí strukturu protoent, která obsahuje jednotlivá pole. Připojení k databázi je otevřeno, je-li potřeba.

Funkce getprotobyname() vrací strukturu protoent ze databáze pro řádek, který vyhovuje jménu name. Připojení k databázi je otevřeno, je-li potřeba.

Funkce getprotobynumber() vrací strukturu protoent z databáze pro řádek, který vyhovuje protokolovému číslu number. Připojení k databázi je otevřeno, je-li potřeba.

Funkce setprotoent() otevře databázi protokolů a nastaví ukazovátko na jeho začátek. Je-li stayopen nenulové, soubor nebude mezi voláními getprotobyname() a getprotobynumber() uzavírán.

Funkce endprotoent() uzavírá spojení s databází.

Struktura protoent je definována v <netdb.h> následovně:

struct protoent {


    char    *p_name;        /* official protocol name */


    char    **p_aliases;        /* alias list */


    int    p_proto;        /* protocol number */
}

Prvky struktury protoent jsou:

p_name

Oficiální jméno protokolu.

p_aliases

Nulovým ukazatelem ukončený seznam přezdívek protokolu.

p_proto

Číslo protokolu.

NÁVRATOVÁ HODNOTA¶

Funkce getprotoent(), getprotobyname() a getprotobynumber() vrací strukturu protoent structure, nebo NULL, jestliže došlo k chybě nebo byl dosažen konec souboru.

SOUBORY¶

/etc/protocols

databáze protokolů

SPLŇUJE STANDARDY¶

4.3BSD, POSIX.1-2001.

DALŠÍ INFORMACE¶

getservent(3), getnetent(3), protocols (5), getprotent_r(3)

TIRÁŽ¶

Tato stránka je součástí projektu Linux man-pages. Popis projektu a informace o hlášení chyb najdete na http://www.kernel.org/doc/man-pages/.